Release 10.1A: OpenEdge Development:
Programming Interfaces

prordbc() - Read CHARACTER Field

The prordbc() function reads the value of a CHARACTER field in a shared buffer.

On successful completion, prordbc() returns 0; otherwise, it returns a non-zero value:

Syntax

int prordbc ( pbufnam, fhandle, index, pvar, punknown, varlen, pactlen ) char *pbufnam; int fhandle; int index; char *pvar; int *punknown; int varlen; int *pactlen;

pbufnam

This input parameter points to the name of the specified shared buffer. You supply the name from your Progress application.

fhandle

This input parameter is the field handle that profldix() returns for the specified field.

index

This input parameter specifies an index value for an array field. If the field is not an array, you must set the value of index to 0.

pvar

This output parameter points to a buffer where prordbc() returns the value of the specified CHARACTER field.

punknown

This output parameter points to an integer where prordbc() returns 1 if the field has the Unknown value (?), and returns 0 otherwise.

varlen

This input parameter contains the length of the buffer that pvar specifies.

pactlen

This output parameter points to an integer where prordbc() returns the actual length (in bytes) of the data in the specified CHARACTER field.

See also

profldix() - Return Field Handle, prordbd() - Read DATE Field, prordbi() - Read INTEGER Field, prordbl() - Read LOGICAL Field, prordbn() - Read DECIMAL Field, prordbr() - Read RECID Field, prowtbc() - Write CHARACTER Field